Skunkware 98/Skunkware 98.iso/src/mail/pine3.96.tar.gz/pine3.96.tar/pine3.96/imap/README

Text File | 1995-09-05 | 9KB | 186 lines

         IMAP2bis/c-client Development Environment
                 5 September 1995
                   Mark Crispin

NOTE: IMAP2bis toolkit 3.6 is the FINAL version of this toolkit that
supports the IMAP2 protocol.  The next IMAP toolkit will be 4.0, which
supports IMAP4 and has *major* internal and external changes.  At the time
of this writing toolkit 4.0 is in alpha test.

Copyright NOTICE:

Some portions Copyright 1988 by The Leland Stanford Junior University.
Copyright 1994 by the University of Washington.

 Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, provided
that the above copyright notices appear in all copies and that both the
above copyright notices and this permission notice appear in supporting
documentation, and that the name of the University of Washington or The
Leland Stanford Junior University not be used in advertising or publicity
pertaining to distribution of the software without specific, written prior
permission.  This software is made available "as is", and
THE UNIVERSITY OF WASHINGTON AND THE LELAND STANFORD JUNIOR UNIVERSITY
DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, WITH REGARD TO THIS SOFTWARE,
INCLUDING WITHOUT LIMITATION ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE, AND IN NO EVENT SHALL THE UNIVERSITY OF
WASHINGTON OR THE LELAND STANFORD JUNIOR UNIVERSITY BE LIABLE FOR ANY
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
CONTRACT, TORT (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.


BUG REPORTING ADDRESS:

     Although this software is not "supported" per se, bugs or questions
regarding this software may be reported to the author:
 Internet:    [e-mail]
 Postal mail:    Mark Crispin
        University of Washington
        Networks and Distributed Computing
        Seattle, WA  98195-4527
        USA
 Phone:        [phone]
 FAX:        [phone]

CONTENTS:

     This directory tree contains the following:

Documentation:
 . README        this file
 . RFC1176.TXT        IMAP2 protocol RFC
 . IMAP2bis.TXT        temporary documentation of MIME extensions for IMAP

Sources:
 . Makefile        master makefile for Unix
 . ANSI            ANSI C sources
 . non-ANSI        source converted into pre-ANSI C

c-client courtesy links:
 . c-client        c-client Application Program Interface (API)
 . ms            Unix MS client (MM-like interface)
 . ipopd        Unix POP2/POP3 servers with IMAP2 client support
 . imapd        IMAP2 server (on Unix, runs under inetd)

NOTES ON THE VARIOUS COMPONENTS:

     ms runs under BSD Unix and requires Columbia's CCMD command package in
a ccmd/ directory at the same level as the root of this directory tree.  If
ccmd is not available, the build of ms is ignored.

     mtest has been run under Unix, DOS, Macintosh, and TOPS-20.  It is a
very primitive interface, however, and is suited mainly as a model of how
to write a main program for the C-Client.  You should take a look at the
source to figure out how to use it.  Briefly, it first asks for a mailbox
name (either a local file path or an IMAP mailbox in the form
{hostname}mailbox) and then puts you in a command mode where "?" will give
you a list of commands.

     The Unix clients ms and/or mtest may be installed on a system
directory.  There is also a man page for ms.  The Pine mailer for Unix and
DOS has IMAP2 support, and is available separately on the
FTP.CAC.Washington.EDU archives.

     The Unix servers ipop2d, ipop3d, and imapd should be installed in a
system daemon directory, and invoked by your /etc/inetd.conf file with
lines such as:

pop    stream    tcp    nowait    root    /usr/local/etc/ipop2d    ipop2d
pop3    stream    tcp    nowait    root    /usr/local/etc/ipop3d    ipop3d
imap    stream    tcp    nowait    root    /usr/local/etc/imapd    imapd

     Note that different variants of Unix have different versions of inetd,
so you should verify the precise form of these commands (for example, some
versions of inetd do not require the "nowait").

     You may also have to edit your /etc/services (or Yellow Pages,
NetInfo, etc. equivalent) to register these services, such as:

pop        109/tcp        postoffice
pop3        110/tcp
imap        143/tcp

     If you want to enable the rimap capability, which allows users with a
suitable client and .rhosts file on the server to access IMAP services
without transmitting her password in the clear over the network, you need
to have /etc/rimapd as a link to the real copy of imapd.  Assuming you have
imapd installed on /usr/local/etc as above:
    % ln -s /usr/local/etc/imapd /etc/rimapd

     Technical note: rimap works by having the client routine tcp_aopen()
invoke `rsh _host_ exec /etc/rimapd' in an child process, and then
returning pipes to that process' standard I/O instead of a TCP socket.  You
can set up `e-mail only accounts' by making the shell be something which
accepts only that string and not ordinary Unix shell commands.

     Before doing a make on UNIX, you should read the top-level Makefile
and see if your system type is known.  The various system types are
three-letter codes, and are described in more detail in the c-client
Makefile.  If your system type is known, then use this as the make option.
After the first time you do a make, this option is remembered in a file
called OSTYPE, so just typing "make" suffices.

     For example, if you are using an IBM AIX 3.2 system on an RS/6000,
your system type is a32, and the appropriate command is:
    make a32

     There are various other make options, described in the c-client
Makefile.  A common additional option is to enable the mbox driver, which
will move mail from /usr/spool/mail into a file called mbox in the user's
home directory.  This is done by specifying the EXTRADRIVERS variable, as
in:
    make a32 EXTRADRIVERS=mbox

     If your system type is not in the top-level Makefile, you first need
to identify whether your compiler supports ANSI C.  This will determine
what source tree to use.  [Note that some compilers, such as Ultrix,
support some aspects of ANSI C but not others; c-client really beats on the
full prototyping capability of ANSI C so you have to use the non-ANSI
source tree for such systems.]  Next, identify a system which is somewhat
close to the system you have.  For BSD-like systems, try the bsd port; for
SVR4-like systems, try the sv4 port.

     It's probably best to see if the unmodified bsd or sv4 ports will work
on your system before inventing a new port.  If you must invent a new port,
you need to create an entry in the top-level and c-client Makefiles for
your new port, as well as os_???.h and os_???.c files with the appropriate
OS-dependent support for that system.  If you send the result back to us,
we will make it available for others using your particular system type.

     If you are building a DOS client, you will need a TCP/IP stack
installed on your DOS system along with its development environment.  The
currently supported stacks are Beame & Whiteside, PC-NFS, Novell, PC/IP,
Waterloo, and Winsock.  mtest and a version of Pine called PC Pine run
under DOS.  You do not use the top-level Makefile under DOS, nor do you
build any components other than c-client.  The DOS makefiles are found in
the c-client directory in the ANSI source tree, and are named according to
the TCP/IP stack in use (e.g. makefile.dnv for DOS/Novell)

     If you are building a Macintosh client, you will need MacTCP installed
on your system as well as the MacTCP C includes and libraries.  mtest runs
on the Macintosh, and is routinely built with THINK C.  Contact me for a
THINK C project file and cute icon for it.

     If you use a Mac C compiler with 2-byte ints (such as THINK C's normal
mode) you will need to fix some bugs in the MacTCP C includes and libraries
to prevent it from generating bad code, since those MacTCP files violate
Apple's standards of always using explicit shorts or longs, never ints.
You could avoid this if you set 4-byte ints in THINK C; however, the ANSI
and UNIX libraries in THINK C use 2-byte ints so you will also need to
build 4-byte int versions of these.  c-client itself is 2-byte int or
4-byte int clean; it can be used in either mode.

     The most important bug in the MacTCP files that you need to fix is in
the file AddressXlation.h, you need to change the definition of the rtnCode
member of the hostInfo structure to be long instead of int.  There are
several other changes you need to make if you decide to compile dnr.c under
THINK C instead of using the Apple-supplied object file; see me for details
if you decide to undertake such an effort.

     The VMS port may or may not build.  You're on your own.

     The TOPS-20 port is known not to build, and I'm not going to bother
fixing it since the newer IMAP-4 toolkit builds on TOPS-20.